Skip to content

feat(nextjs): Support rendering ClerkProvider in client components - #1840

Merged
brkalow merged 7 commits into
mainfrom
brk.feat/app-router-client-provider
Oct 18, 2023
Merged

feat(nextjs): Support rendering ClerkProvider in client components#1840
brkalow merged 7 commits into
mainfrom
brk.feat/app-router-client-provider

Conversation

@brkalow

@brkalow brkalow commented Oct 6, 2023

Copy link
Copy Markdown
Member

Description

Allow ClerkProvider to be rendered in client components in App Router. This is accomplished by introducing a "compat" layer that uses next/compat/router to detect the presence of the pages router. If detected, we render the pages provider, otherwise we render the app router provider.

fixes JS-573

Checklist

  • npm test runs as expected.
  • npm run build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Packages affected

  • @clerk/clerk-js
  • @clerk/clerk-react
  • @clerk/nextjs
  • @clerk/remix
  • @clerk/types
  • @clerk/themes
  • @clerk/localizations
  • @clerk/clerk-expo
  • @clerk/backend
  • @clerk/clerk-sdk-node
  • @clerk/shared
  • @clerk/fastify
  • @clerk/chrome-extension
  • gatsby-plugin-clerk
  • build/tooling/chore

@changeset-bot

changeset-bot Bot commented Oct 6, 2023

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 83f81fb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@clerk/nextjs Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@brkalow

brkalow commented Oct 6, 2023

Copy link
Copy Markdown
Member Author

!snapshot

@clerk-cookie

Copy link
Copy Markdown
Collaborator

Hey @brkalow - the snapshot version command generated the following package versions:

Package Version
@clerk/backend 0.30.3-snapshot.e42e882
@clerk/chrome-extension 0.4.6-snapshot.e42e882
@clerk/clerk-js 4.60.1-snapshot.e42e882
@clerk/clerk-expo 0.19.8-snapshot.e42e882
@clerk/fastify 0.6.13-snapshot.e42e882
gatsby-plugin-clerk 4.4.14-snapshot.e42e882
@clerk/nextjs 4.25.3-snapshot.e42e882
@clerk/clerk-react 4.26.3-snapshot.e42e882
@clerk/remix 3.0.5-snapshot.e42e882
@clerk/clerk-sdk-node 4.12.12-snapshot.e42e882
@clerk/shared 0.24.3-snapshot.e42e882

Tip: use the snippet copy button below to quickly install the required packages.

# @clerk/backend
npm i @clerk/backend@0.30.3-snapshot.e42e882
# @clerk/chrome-extension
npm i @clerk/chrome-extension@0.4.6-snapshot.e42e882
# @clerk/clerk-js
npm i @clerk/clerk-js@4.60.1-snapshot.e42e882
# @clerk/clerk-expo
npm i @clerk/clerk-expo@0.19.8-snapshot.e42e882
# @clerk/fastify
npm i @clerk/fastify@0.6.13-snapshot.e42e882
# gatsby-plugin-clerk
npm i gatsby-plugin-clerk@4.4.14-snapshot.e42e882
# @clerk/nextjs
npm i @clerk/nextjs@4.25.3-snapshot.e42e882
# @clerk/clerk-react
npm i @clerk/clerk-react@4.26.3-snapshot.e42e882
# @clerk/remix
npm i @clerk/remix@3.0.5-snapshot.e42e882
# @clerk/clerk-sdk-node
npm i @clerk/clerk-sdk-node@4.12.12-snapshot.e42e882
# @clerk/shared
npm i @clerk/shared@0.24.3-snapshot.e42e882

@@ -0,0 +1,19 @@
'use client';

import { useRouter } from 'next/compat/router';

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this a stable export we can rely on being available?

Or are we reaching into private APIs here?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe it is stable and reliable, based on PR: vercel/next.js#42502.

export function ClerkProvider(props: NextClerkProviderProps) {
const router = useRouter();

const Provider = router ? PageClerkProvider : ClientClerkProvider;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The solution here makes perfect sense to me :)
Do you think we could merge the two client providers into one? I took a quick look and they look pretty similar.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nikosdouvlis possibly, the difficulty is they rely on the two different router hooks, which is why we need this layer. We could abstract the dependency on the router into a prop and use this layer to compute the prop to pass down to single provider.

@brkalow
brkalow marked this pull request as ready for review October 18, 2023 04:51
@brkalow
brkalow requested a review from a team as a code owner October 18, 2023 04:51
import type { Application } from '../models/application';
import { appConfigs } from '../presets';

test.describe('next build @nextjs', () => {

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nikosdouvlis Any feedback on the test? 🙏

Comment thread package.json
"test:integration:base": "DEBUG=1 npx playwright test --config integration/playwright.config.ts",
"test:integration:generic": "E2E_APP_ID=react.vite.* npm run test:integration:base -- --grep @generic",
"test:integration:nextjs": "E2E_APP_ID=next.appRouter.withEmailCodes npm run test:integration:base -- --grep @generic",
"test:integration:nextjs": "E2E_APP_ID=next.appRouter.withEmailCodes npm run test:integration:base -- --grep \"@generic|@nextjs\"",

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed in the initial RFC, I added a @nextjs tag as well.

Comment on lines +76 to +79
log: (msg: string) => {
buildOutput += `\n${msg}`;
log(msg);
},

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Captures and makes the build output available by way of app.buildOutput. This allows us to assert on the output.

@anagstef anagstef left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💯

@brkalow
brkalow added this pull request to the merge queue Oct 18, 2023
Merged via the queue into main with commit a0e6783 Oct 18, 2023
@brkalow
brkalow deleted the brk.feat/app-router-client-provider branch October 18, 2023 14:36
@clerk-cookie clerk-cookie mentioned this pull request Oct 18, 2023
@clerk-cookie

Copy link
Copy Markdown
Collaborator

This PR has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.

@clerk clerk locked as resolved and limited conversation to collaborators Oct 18, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants